Skip to content

feat: Release notes for new docs #9091

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 21 commits into from
Nov 3, 2025
Merged

feat: Release notes for new docs #9091

merged 21 commits into from
Nov 3, 2025
+3,990 −334

Conversation

@snowystinger
Copy link
Member

@snowystinger snowystinger commented Oct 24, 2025

Closes

Starting point for release notes

✅ Pull Request Checklist:

  • Included link to corresponding React Spectrum GitHub Issue.
  • Added/updated unit tests and storybook for this change (for new code or code which already has tests).
  • Filled out test instructions.
  • Updated documentation (if it already exists for this component).
  • Looked at the Accessibility Practices for this feature - Aria Practices

📝 Test Instructions:

🧢 Your Project:

@rspbot
Copy link

rspbot commented Oct 24, 2025

Build successful! 🎉

@nwidynski

This comment was marked as outdated.

Sign in to view
@snowystinger

This comment was marked as outdated.

Sign in to view
@rspbot
Copy link

rspbot commented Oct 27, 2025

Build successful! 🎉

@rspbot
Copy link

rspbot commented Oct 27, 2025

Build successful! 🎉

@snowystinger snowystinger marked this pull request as ready for review October 27, 2025 04:49
@rspbot
Copy link

rspbot commented Oct 27, 2025

Build successful! 🎉

@rspbot
Copy link

rspbot commented Oct 27, 2025

Build successful! 🎉

@rspbot
Copy link

rspbot commented Oct 27, 2025

Build successful! 🎉

@yihuiliao
Copy link
Member

yihuiliao commented Oct 27, 2025

I think the overall structure looks good. Did we ever discuss if we want the contents of the S2 release notes to be structured like our old docs, or if we plan to leave it the same as what we had in storybook?

As for the RAC release notes, do we need to update the release notes to filter out any V3 changes (or did you already do that?)

reidbarber
reidbarber previously approved these changes Oct 27, 2025
View reviewed changes
Copy link
Member

@reidbarber reidbarber left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It might be nice to have Breadcrumbs at the top of the release pages with a link back to the Releases page.

devongovett
devongovett reviewed Oct 27, 2025
View reviewed changes
Copy link
Member

@devongovett devongovett left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we'll need to fix the links somehow

@devongovett
Copy link
Member

devongovett commented Oct 27, 2025

are we only including releases back to the start of RAC? what about ones before that?

reidbarber
reidbarber reviewed Oct 27, 2025
View reviewed changes
reidbarber

This comment was marked as outdated.

Sign in to view

@rspbot
Copy link

rspbot commented Oct 27, 2025

Build successful! 🎉

@rspbot
Copy link

rspbot commented Oct 28, 2025

Build successful! 🎉

@snowystinger
Copy link
Member Author

snowystinger commented Oct 28, 2025

@devongovett

are we only including releases back to the start of RAC? what about ones before that?

My thoughts on this right now.
Hard break on release notes, start at 1.0 for RAC, start at 0.1 for S2

Anything before that will likely be filled with broken links etc, they should be preserved for the future though. I propose either keeping them in unused mdx files in our repo, or copying their contents to the appropriate GitHub release tag with a disclaimer that the urls may not link to the correct place or may just be broken.

@snowystinger
Merge branch 'main' into new-docs-release-notes
0682763 
# Conflicts:
#	packages/dev/s2-docs/src/CodeBlock.tsx
#	packages/dev/s2-docs/src/Layout.tsx
@rspbot
Copy link

rspbot commented Oct 28, 2025

Build successful! 🎉

yihuiliao
yihuiliao reviewed Oct 29, 2025
View reviewed changes
Copy link
Member

@yihuiliao yihuiliao left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it would be nice if there was a chevron left at the top so that you can easily get back to the release page rather than having to click on it in the side nav

@snowystinger
Merge branch 'main' into new-docs-release-notes
55b6606 
# Conflicts:
#	packages/dev/s2-docs/src/Code.tsx
#	packages/dev/s2-docs/src/CodeBlock.tsx
@rspbot
Copy link

rspbot commented Oct 30, 2025

Build successful! 🎉

@rspbot
Copy link

rspbot commented Oct 30, 2025

Build successful! 🎉

@rspbot
Copy link

rspbot commented Oct 30, 2025

Build successful! 🎉

yihuiliao
yihuiliao reviewed Oct 30, 2025
View reviewed changes
@rspbot
Copy link

rspbot commented Oct 30, 2025

Build successful! 🎉

@rspbot
Copy link

rspbot commented Oct 31, 2025

Build successful! 🎉

reidbarber
reidbarber previously approved these changes Oct 31, 2025
View reviewed changes
packages/dev/s2-docs/pages/react-aria/releases/index.mdx
export const section = 'Releases';
export const tags = ['changelog', 'versions', 'updates'];

# Releases
Copy link
Member

@reidbarber reidbarber Oct 31, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Existing issue, but this page doesn't have "Releases" in the meta title. Same for the Examples page.

@rspbot
Copy link

rspbot commented Nov 3, 2025

Build successful! 🎉

@rspbot
Copy link

rspbot commented Nov 3, 2025

Build successful! 🎉

@rspbot
Copy link

rspbot commented Nov 3, 2025

Build successful! 🎉

@rspbot
Copy link

rspbot commented Nov 3, 2025

Build successful! 🎉

yihuiliao
yihuiliao approved these changes Nov 3, 2025
View reviewed changes
@snowystinger snowystinger added this pull request to the merge queue Nov 3, 2025
Merged via the queue into main with commit 7898846 Nov 3, 2025
32 checks passed
@snowystinger snowystinger deleted the new-docs-release-notes branch November 3, 2025 19:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@devongovett devongovett devongovett left review comments

@reidbarber reidbarber reidbarber approved these changes

@yihuiliao yihuiliao yihuiliao approved these changes

Assignees

No one assigned

Labels

ready for review

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

7 participants

@snowystinger @rspbot @nwidynski @yihuiliao @devongovett @reidbarber